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Foreword 



rd , 



This Technical Specification has been produced by the 3 Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 



rd , 



The present document is part of a TS-family covering the 3 Generation Partnership Project Technical Specification 
Group Services and System Aspects, Telecommunication management; as identified below: 

32.531: Software management; Concepts and Integration Reference Point (IRP) Requirements 

32.532: Software management Integration Reference Point (IRP); Information Service (IS) 

32.533: Software management Integration Reference Point (IRP); Common Object Request Broker 

Architecture (CORE A) Solution Set (SS) 
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1 Scope 

The present document contains the Software Management Interface IRP Information Services descriptions. 

2 References 

The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[1] 3GPP TR 21.905: "Vocabulary for 3GPP Specifications". 

[2] 3GPP TS 32.101: "Telecommunication management; Principles and high level requirements". 

[3] 3GPP TS 32.102: "Telecommunication management; Architecture". 

[4] 3GPP TS 21.905: "Vocabulary for 3GPP Specifications". 

[5] 3GPP TR 32.816: "Telecommunication management; Study on Management of Evolved Universal 

Terrestrial Radio Access Network (E-UTRAN) and Evolved Packet Core (EPC)". 

[6] 3GPP TS 32.531: "Telecommunication management; Software management; Concepts and 

Integration Reference Point (IRP) Requirements". 

[7] 3GPP TS 32.622: "Telecommunication management; Generic network resources Integration 

Reference Point (IRP); Network Resource Model (NRM)". 

[8] 3GPP TS 32.312: "Telecommunication management; Generic Integration Reference Point (IRP) 

management: Information Services". 

[9] 3GPP TS 32.302: Telecommunication management; Configuration Management (CM); 

Notification Integration Reference Point (IRP); Information Service (IS). 



3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions given in TS 32.101 [2], TS 32.102 [3] and 

TR 21.905 [4] and the following apply. A term defined in the present document takes precedence over the definition of 

the same term, if any, in TS 32.531 [6], TS 32.101 [1], TS 32.102 [2] and TS 21.905 [4], in that order. 

3.2 Abbreviations 

For the purposes of the present document, the abbreviations given in TR 21.905 [4], TS 32.531 [6] and the following 
apply. An abbreviation defined in the present document takes precedence over the definition of the same abbreviation, if 
any, in TR 21.905 [4] and TS 32.531 [6]. 
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4 

4.1 



Information Object Classes 

Imported information entities and local labels 



Label reference 


Local label 


3GPP TS 32.622 [7], information object class, Top 


top 


3GPP TS 32.312 [8], information object class, managedGenericIRP 


managedGenericIRP 



4.2 Class diagram 

4.2.1 Attributes and relationships 

The diagram reflects the definitions in the text of the following clauses. In case of conflict text takes 
precedence. 



«lnformationObjectClass» 
SwManagement IRP 



+theSWManagementlRP 



relation-swManagementlRP-svMihagementCapabilitie: 



+theSWManagementCapabilities,,, -Q, n 



1 +theSWManagementlRP 

relation-swManagementlRP-swProcess 

+theSWProcess 




«lnformationObiectClass» 
SwMProcess 



relation-swManagementCapabilities-swImqagementProfile 



+theSwManagementProfile 



7Jj:jr 



relation-swManagementProfile-swProcess 



theSWManagementProfile 



«lnformalionObjectClass» 
SwMProfile 
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4.2.2 Inheritance 

The diagram reflects the definitions in the text of the following clauses. In case of conflict text takes 
precedence. 



«lnformationObjectClass>;- 
ManagedGenericIRP 

(from TS 32.312) 



A 



« I nformationObjectClass» 
SwManagement IRP 



«lnformationObjectClass>;- 
Top 

(from TS 32.622) 



«lnformationObjectClass» 
GenManCapabilities 
ki 

nElnformation 

offered FinalAdministrativeStatelnformatic^n 
stepsAndOfferedStopPointList 



«lnformationObjectClass» 

SwMCapabilities 

swVersionToBelnstalledOfferLisI 



« I nformationObjectClass» 
GenManProfile 
Id 

selected FinalAdministrativeStatft 
nElnformation 

stepsAndSelectedStopPointList 
versionNumber 



«lnformationObjectClass» 

SwMProfile 

swVersionToBelnstalled 



«lnformationObjectClass» 

GenManProcess 
id 

nEldentification 
profileld 
steplnfoList 



A 



«lnformationObjectGlass>;- 
SwMProcess 
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4.3 Information object class definitions 

4.3.1 GenManCapability 



4.3.1.1 



Definition 



This object class is a support object class. Sub-classes of this IOC represent the IRPAgent's 
capability in support of automated management. 

It is created by the IRP Agent and cannot be modified by the IRPManager. 

An instance of a sub-class of genManCapability object is valid for a certain NE type or a set of NE 

types. 

Multiple genManCapability objects may be instantiated in the IRP Agent. 

The object identifies 

a) the sequence of the self-configuration steps 
and for each step 

a.l) the possibility, whether before the step a stop point can be selected, such that the self- 
configuration step is suspended and waits for a request by the IRPManager to resume. 

b) the final administrativestate (ITU-T X.731) of the NE after successful self-configuration. 



4.3.1.2 



Attributes 



Attribute name 


Support Qualifier 


Read Qualifier 


Write Qualifier 


id 


M 


M 


- 


nEInf ormation 


M 


M 


- 


stepsAndOf f eredStopPointList 


M 


M 


- 


of f eredFinalAdmini St rat iveS tat einf ormation 


M 


M 


- 



4.3.1.3 Notifications 

None. 
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4.3.2 GenManProfile 



4.3.2.1 



Definition 



This object class is a support object class. Sub-classes of this IOC represent the IRPManager' s decision 
related to automated management. 

An instance of a sub-class of GenManProfile is valid for a certain NE type or a set of NE types. 
For an NE starting its self-configuration process (see genManProcess) there shall be no ambiguity 
which instance of a sub-class of GenManProfile is valid for a certain NE type or a set of NE types. 
Multiple instances of sub-classes of GenManProfile objects may be instantiated in the IRP Agent. 

By using an instance of a sub-class of this object the IRPManager decides which of the possible 
stop points offered in the related instance of a sub-class of genManCapability are used to suspend 
the automated management process of the specified NE type (or set of NE types) and which of the 

of f eredFinalAdministrativeStatelnf ormation is selected. 



4.3.2.2 



Attributes 



Attribute name 


Support Qualifier 


Read Qualifier 


Write Qualifier 


id 


M 


M 


- 


versionNumber 


M 


M 


- 


nEInf ormation 


M 


M 


- 


stepsAndSelectedStopPointList 


M 


M 


- 


select edFinalAdmini St rat iveSt ate 


M 


M 


- 



4.3.2.3 Notifications 

None. 
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4.3.3 



GenManProcess 



4.3.3.1 



Definition 



This object class is a support object class. Sub-classes of this IOC describe the automated management 
process for an NE. They allow the IRPManager to be informed about the current progress of the process and 
where stop points are set. No intervention of the IRPManager is foreseen except resume after a stop point 
was reached or termination of the self-configuration. 

When the automated management process for an NE starts, an instance of the sub-class of genManProcess 
is created automatically. 

The steps in the stepinf oList shall conform to the content of the relevant sub-class of genManProf ile 

instance. 

Example: 

If the stepsAndOf feredStopPointList of a sub-class instance of genManProf ile indicates 

stopPointCanBeSetBeforeThisStep for step X, then the entry for stepX in the stepinf oList of the 

sub-class instance of genManProcess can only have the value stopPointisNotSet . 

When there is no relevant genManProf ile at creation time of genManProcess, then the IRP Agent creates 
the genManProcess based on the relevant genManCapability. In this case preferably no stop point shall 
be set in the self configuration process. 

When the last step of the self configuration process is completed successfully, the genManProcess instance 
is deleted automatically. 

When self configuration process is terminated by the IRPManager, the genManProcess instance is deleted 
automatically. 



4.3.3.2 



Attributes 



Attribute name 


Support Qualifier 


Read Qualifier 


Write Qualifier 


id 


M 


M 


- 


nEIdentif ication 


M 


M 


- 


prof ileld 


M 


M 


- 


stepinf oList 


M 


M 


- 



4.3.3.3 Notifications 

None. 



£75/ 



3GPP TS 32.532 version 9.2.1 Release 9 



14 



ETSI TS 132 532 V9.2.1 (2010-01) 



4.3.4 SwMCapability 



4.3.4.1 



Definition 



This object class is a sub-class of genManCapability and represents the IRPAgent's capability in 
support of SWM. 

It is created by the IRP Agent and cannot be modified by the IRPManager. 

A SwMManagementCapability object is valid for a certain NE type or a set of NE types with a 
certain SW version or set of versions. For an NE there shall be no ambiguity which 
SwMManagementCapability object is valid for the NE. 
Multiple SwMManagementCapability objects may be instantiated in the IRP Agent. 

The object identifies 

a) the sequence of the self-configuration steps 
and for each step 

a.l) the possibility, whether before the step a stop point can be selected, such that the self- 
configuration step is suspended and waits for a request by the IRPManager to resume. 

b) the final administrativestate of the NE after successful self -configuration. 

Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ SWM FUN 5 




3GPP TS 32.531 [6] 


REQ ASWM FUN 1 





4.3.4.2 Attributes 

All attributes inherited from IOC GenManCapability . 
Additional attributes: 



^^^^^F Attribute name ^B^ 


Support Qualifier 


Read Qualifier 


Write Qualifier 


swVersionToBelnstalledOf f erList 


CM*) 


M 


- 



*) Condition: objectClass_is_swMCapability 



4.3.4.3 



Attribute constraints 



Name 


Definition 


objectClass_is_swMCapability 


ob j ectClass is equal to swMCapabilities 



4.3.4.4 



Notifications 



Name 


Qualifier 


Notes 


not ifyNewSwAvai lability 
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4.3.5 



SwMProf ile 



4.3.5.1 



Definition 



This object class is a sub-class of genManProf ile. It allows the IRPManager to select from the stop points 
offered in the swMCapabilites object those which should be used to stop the SW management process for 
NEs, which fit to the nEInf ormation and swVersionToBelnstalled, and which of the 
of f eredFinalAdministrativeStatelnf ormation is selected. 

For an NE starting its SWM process there shall be no ambiguity which swMManagementProf ile is valid 
for the NE. Therefore the nEinf ormation of different swMProf ile instances shall not intersect. Example 
for a not allowed intersection: profile 1 has nEinf ormation= (neType=eNB), profile 2 has 
nEInf orination= ( (neType=eNB) and (Id=l)) ). 

Infonnation on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 1 




3GPP TS 32.531 [6] 


REQ ASWM FUN 2 




3GPP TS 32.531 [6] 


REQ ASWM FUN 3 




3GPP TS 32.531 [6] 


REQ ASWM FUN 4 




3GPP TS 32.531 [6] 


REQ SWM FUN 7 


The part of the requirement to avoid 
service impact can be fulfilled by creating a 
swmProfile with 

selectedFinalAdministrativeState 
equal locked 



4.3.5.2 Attributes 

All attributes inherited from IOC GenManProf ile . 
Additional attributes: 



Attribute name 


Support Qualifier 


Read Qualifier 


Write Qualifier 


SwVersionToBelnstalled 


CM 


M 


- 



Condition: objectClass_is_swMProf ile 



4.3.5.3 



Attribute constraints 



Name 


Definition 


objectClass is swMProf ile 


objectClass is equal to swMProf ile 



4.3.5.4 



Notifications 



Name 


Qualifier 


Notes 


notify S wMProf ileCreation 


M 




notify S wMProf ileChange 


CM 


Condition: Present if operation changeSwMProf ile is supported. 


notifySwMProfileDeletion 


M 
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4.3.6 



SwMProcess 



4.3.6.1 



Definition 



This object class is a sub-class of genManProcess . It describes the SW management process for an NE. It 
allows the IRPManager to be informed about the current progress of the SWM process and where stop points 
are set. No intervention of the IRPManager is foreseen except to provide indication to resume after a stop 
point was reached or to abort the self -configuration. 

When the automated management process for an NE starts, an instance of the swMProcess is created 
automatically. 

The id of the swMProcess shall be identical to the identifier of the NE and identify the swMProcess 
instance uniquely. 

The steps in the stepinf oList shall conform to the content of the relevant swMProf ile instance. 
Example: 

If the stepsAndOf f eredStopPointList of swMProf ile indicates 

stopPointCanBeSetBef oreThisStep for step X, then the entry for step X in the stepinf oList of 

swMProcess can only have the value stopPointisNotset . 

When there is no relevant swMProf ile at creation time of swMProcess, then the IRP Agent creates the 
swMProcess based on the relevant swMCapability. In this case preferably no stop point shall be set in the 
self configuration process. 

When the last step of the self configuration process is completed successfully, the swMProcess instance is 
deleted automatically. 

When self configuration process is terminated by the IRPManager, the swMProcess instance is deleted 
automatically. 

Infonnation on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment , 


3GPP TS 32.531 [6] 


REQ ASWM FUN 2 




3GPP TS 32.531 [6] 


REQ ASWM FUN 3 




3GPP TS 32.531 [6] 


REQ ASWM FUN 4 




3GPP TS 32.531 [6] 


REQ ASWM FUN 5 




3GPP TS 32.531 [6] 


REQ ASWM FUN 6 





4.3.6.2 Attributes 

All attributes inherited from IOC GenManProcess . 
Additional attributes: None. 



4.3.6.3 



Notifications 



Name 


Qualifier 


Notes 


notifySwMProcessCreation 


M 




notifySwMProcessStage 


M 




notif y S wMProces sDeletion 


M 
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4.3.7 SwMIRP 

4.3.7.1 Definition 

This information object represents a Software Management IRP. It inherits from IOC managedGenericIRP. 

4.3.7.2 Attributes 

All attributes inherited from IOC managedGenericIRP . 
Additional attributes: None. 

4.3.7.3 Notifications 

All notifications inherited from IOC managedGenericIRP . 
Additional notifications: None. 

4.3.8 SwMManagedEntity 
4.3.8.1 Definition 

The proxy IOC, SwMManagedEntity represents the role that can be played by an instance of a managed element. 
The objectClass and objectlnstance identify a managed element instance. 

4.4 Information relationship definitions 

4.4.1 relation-swMIRP-swMCapability (M) 

4.4.1.1 Definition 

This represents the relationship between SwMIRP and SwMCapability. 

4.4.1.2 Roles 



Name 


Definition 


theSwmIRP 


It represents the SwmIRP . 


theSwMCapability 


It represents the SwMCapability 



4.4.1.3 Constraints 

There is no constraint for this relationship. 
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4.4.2 relation-SwmlRP-swMProf ile (M) 
4.4.2.1 Definition 

This represents the relationship between SwmIRP and SwMProf ile. 



4.4.2.2 



Roles 



Name 


Definition 


theSwmIRP 


It represents the SwmIRP . 


theSwMProf ile 


It represents the SwMProf ile . 



4.4.2.3 Constraints 

There is no constraint for this relationship. 

4.4.3 relation-swMIRP-swMProcess (M) 

4.4.3.1 Definition 

This represents the relationship between SwmIRP and SwMProcess. 

4.4.3.2 Roles 



Name 


Definition 


theSwMIRP 


It represents the SwMIRP . 


theSwMProcess 


It represents the SwMProcess . 



4.4.3.3 Constraints 

There is no constraint for this relationship. 
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4.4.4 relation-swMCapabilites-swMProf ile (M) 

4.4.4.1 Definition 

This represents the relationship between swMCapability and swMProf ile. 

4.4.4.2 Roles 



Name 


Definition 


theSwMCapability 


It represents the swMCapability . 


theSwMProf ile 


It represents the swMProf ile . 



4.4.4.3 



Constraints 



A relation can only exist between a SwMProf ile and a SwMCapability when 
a) all steps which are entries in the stepsAndSelectedStopPointList of SwMProf ile have 
stopPointCanBeSetBef oreThisStep = Yes in the stepsAndOf f eredStopPointList of the 
SwMCapability.b) nEInformation of SwMProf ile is a subset of nEInf ormation of 
SwMCapability : 

4.4.5 relation swMProfile-swMProcess (M) 
4.4.5.1 Definition 

This represents the relationship between SwMProf ile and SwMProcess. 



4.4.5.2 



Roles 



4.4.5.3 



Name 


Definition 


theSwMProf ile 


It represents the theSwMProf ile . 


theSwMProcess 


It represents the SwMProcess . 



Constraints 



A SwMProcess shall perform all self-configuration steps according to stepsAndOff eredStopPointList of 
SwMProf ile. 

A relation can only exist between a SwMProcess and a SwMProf ile when 

nEIdentif ication of SwMProcess falls into nEInformation of SwMProf ile. 
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4.5 



Information attribute definitions 



4.5.1 Definition and legal values 



Attribute Name 


Definition 


Legal Values 


id 


It identifies uniquely an instance of its object class. 




nEIdentif ication 


Tiiis attribute identifies the NE for which the self management activity is done. 




nEInformation 


This attribute defines the neType or NE instance/s - with optional software identification 
information - , for which this capability/profile instance is valid. 


"NE instance/s" only applies for instance/s already known to the 
IRPManager, e.g. in case of re-configuration or SW update. 


startStepName 


nameOfStep, this attribute defines the start step for resume operation. 


The legal value of startStepName could be one of the step which defined 
in StepsAndOf f eredStopPointList 


swVersionToBelnstalled 


This attribute describes which SW identification information shall be used at the end of self 
management in NEs for which this swMCapability/swMProf ile apphes. 




stepsAndOf f eredStopPoint 

List 


Each entry in the list contains for each step the following information: 

• nameOfStep: 

This list shall be exhaustive; if a certain step is not visible or not supported in the SWM 
process, then it shall not be shown (listed) in the stepsAndOf f eredStopPointList. 

• sequenceNumberlnProcess 

• stopPointCanBeSetBef oreThisStep 


nameOfStep : 

swDownload, 

swinstallation, 

swActivation 

More values for nameOfStep may be used by other IRPs. 

All steps may be offered as stop points. 

sequenceNumberlnProcess : 
Positive Integer 

StopPointCanBeSetBef oreThisStep; Yes, No 


stepsAndSelectedStopPoin 
tList 


Each entry in the list contains for each step the following information: 

• nameOfStep: 

• sequenceNumberlnProcess 

• stopPointSetlndication 


nameOf SwMStep, 

sequenceNumberlnProcess ; 

see StepsAndOf f eredStopPointList 

StopPointSetlndication : 

stopPoint I sSetBef oreThisStep, stopPointlsNotSet 
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stepInfoList 


This list attribute contains information about all steps and how far they have progressed. Each 
entry in the list contains: 

• nameOfStep 

• sequenceNumberlnProcess 

• stopPointSetlndication 

• stepProgress 


nameOfSwMStep, 

sequenceNumberlnProcess : 

see stepsAndOf f eredStopPointList 

StopPointSetlndication : 

see stepsAndSelectedStopPointList 

StepProgress : 

notYetStarted, 

running, 

completed, 

awaitingResume , 

failure, 

terminated 


swMprocessList 


This attribute contains information about the instances of swMProcess . Each entry in the list 
contains (SET OF): 

• id 

• nEIdentif ication 

• StepInfoList 


See individual definitions of the list entry content. 


of f eredFinalAdministrati 
veState Information 


It describes which selection is offered regarding the administrativeState of the NE after 
successful automated management: If it may have the value locked or unlocked or if the value of 
the administrativeState may be determined by the configuration data which is uploaded in the 
course of the automated management. 


One or more of the following values: 

locked, 

unlocked, 

determinedByConf igurationData 

The value unlocked should always be present. 


selectedFinalAdministrat 
iveState 


Determines which of the offers made regarding the administrativeState of the NE after successful 
self-configuration is taken. 


One of the following values: 

locked, 

unlocked, 

determinedByConf igurationData 

Default value is value unlocked. 


swVersionToBelnstalledOf 
f erList 


This list describes for which SW version/s the capability object is valid. 


Minimum size of list: 1 entry 


versionNumber 


This number is the version number of a profile. Its value is 1 when a profile is created. It is 
incremented by 1 each time a profile is successfully changed. 


Integer 


prof ileld 


This parameter records the identification of the profile used by the process. It consists of two 
data: 

• id (of the profile) 

• versionNumber 


See versionNumber 


matchingNEInformation 


This parameter records the information of the NE which was matching with the nEInformation of 
the profile when determining which profile is to be used for the process. 


See nEInformation 
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result 


This parameter records the resuh of an operation. 


success, 
failure, 

stepNameNotMatch: The current process step doesn't match the 
startStepName in the operation. 

nEinformationintersection : There shall be no ambiguity 
which swMManagementProfile is valid for the NE. Therefore the 
nEinf ormation of different swMProf ile instances shall not 
intersect. Example for a not allowed intersection: profile 1 has 
nEinformation= (neType=eNB), profile 2 has 
nEinformation= ( (neType=eNB) and (ld=1)). 



4.5.2 Constraints 



Name 


Definition 


FFS 
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5 IRP descriptions: Interface Definitions 

5.1 Class diagram representing interfaces 



«lnterface» 
SwMOperations_1 

createSwMProfileQ 

deleteSwMProftleQ 

listSwMCapabilitiesQ 

listSwMProcesses() 

listSwMProfilesO 

resumeSwMProcessO 

terminateSwMProcess() 



«realize>>\ 



«lnterface» 
SwMOperations_2 

changeSwMProfileO 



«may realizes 



«lnformationObjectClass» 
NotificationIRP 
(from TS 32.302) 



A 



«agent-internal-usage» 



«SupportlOC» 
SwManagementlRP 



«may realize» 



«lnterface» 
SwMOperattons_3 

downloadNESwO 

activate NESw() 




^ 



«lnterface» 
SwMOperations_4 



«may uses>:? 



«Notification» 
SwMNotifications_1 

fyNewSwMCapabilitiesAvailabilityO 

fySwMProcessCreationQ 

fySwMProcessDeletionQ 

fySwMProcessStageO 

fySwMProfileCreationO 

fySwMProfileDeletionQ 



«Notification» 
SwMNotifications_2 



> 



notifySwMProfileChangeQ 



«Notification» 
SwMNotifications_3 



notifyDownloadNESwStatusChangedO 

notifyActivateNESwStatusChangedQ 



^i^ 



«Notification» 
SwMNotifications_4 



installNESwO 



notifylnstallNESwStatusChangedO 



Additionally, the operations and notifications of this document are specified and grouped under Interfaces as shown in 
the following sections. To allow the flexible support of the necessary and sufficient operations and notifications for 
software management, the operations and notifications of this specification are packaged into two groups, one related to 
automatic software management (ASWM) and the other related to non-automated software management (NASWM). 

Automatic Software Management requires the following operations and notifications: 

1. SwMOperations_l and SwMNotifications_l shall be mandatory 

2. SwMOperations_2 and SwMNotifications_2 shall be optional 

Non Automatic Software Management requires the following operations and notifications: 

1. SwMOperations_3 and SwMNotifications_3 shall be mandatory 

2. SwMOperations_4 and SwMNotifications_4 shall be optional 
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«lnterface» 
SwMOperations_1 



createSwMProfileO 

deleteSwMProfileO 

listSwMCapabilitiesO 

listSwMProcesses() 

listSwMProfilesO 

resumeSwMProcessO 

terminateSwMProcess() 




«SupportlOC» 
SwManagementIRP 



«Notification» 
SwMNotifications_1 

fyNewSwMCapabilitiesAvailabilityO 

fySwM ProcessCreation 

fySwM ProcessDeletion 

fySwM ProcessStageO 

fySwMProfileCreationO 

fySwMProfileDeletionO 



«agent-intemal-usage> 



«lnformationObjectClass» 
NotificationIRP (from 32.302) 



«may realize>s^ 



«lnterface» 
SwMOperations_2 



changeSwMProfileO 



«may use» 



^^ 



«Notification» 
SwMNotifications_2 

notifySwMProfileChangeO 



Figure 5.1-2 Operations and Notifications for ASWI\/I 



«lnterface» 
SwMOperations_3 




«Notification» 
SwMNotifications_3 



notifyDownloadNESwStatusChangedQ 
notifyActivateNESwStatusChanged{) 



«agGnt-internal-usage» 



«SupportlOC» 
SwManagementIRP 



«lnformationObjectCla 
NotificationIRP {from 32.302) 



:^_ 



«Notification» 
SwMNotifications_4 



notifylnstallNESwStatusChangedO 



Figure 5.1-3 Operations and Notifications for NASWIU! 



5.2 Generic rules 

Rule 1: each operation with at least one input parameter supports a pre-condition valid_input_parameter which 
indicates that all input parameters shall be valid with regards to their information type. Additionally, each such 
operation supports an exception operation_failed_invalid_input_parameter which is raised when pre-condition 
valid_input_parameter is false. The exception has the same entry and exit state. 

Rule 2: each operation with at least one optional input parameter supports a set of pre-conditions 
supported_optional_input_parameter_xxx where "xxx" is the name of the optional input parameter and the pre- 
condition indicates that the operation supports the named optional input parameter. Additionally, each such 
operation supports an exception operation_failed_unsupported_optional_input_parameter_xxx which is raised 
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when (a) the pre-condition supported_optional_input_parameter_xxx is false and (b) the named optional input 
parameter is carrying information. The exception has the same entry and exit state. 

Rule 3: each operation shall support a generic exception operation_failed_internal_problem which is raised 
when an internal problem occurs and that the operation cannot be completed. The exception has the same entry 
and exit state. 

NOTE: These rules are mapped at the solution set level. Pre-conditions and exceptions, generated by these rules, 
need not appear explicitly in the present document. 



5.3 SwMIRPOperations_1 Interface (M) 



Editor's Note: Whether automatic software management interface is optional or mandatory need further study. 



5.3.1 Operation listSwMCapabilities (M) 



5.3.1.1 



Definition 



This operation allows the IRPManager to determine on the Itf-N interface which steps in the SW 
management are performed in NEs of a certain type, what is done by the NE in case a step does not perform 
normally and before which steps a stop point can be set, such that the software download halts and waits for 
a continuation request by the IRPManager. 

Infotmation on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 1 





5.3.1.2 



Input parameters 



Parameter 
Name 


Qualifier 


Information type 


Comment 


nEInf ormation 


M 


swM. nEInf ormation 


If this input parameter contains no information, all (offered) 
SwMCapability instances are to be listed in the output. 



5.3.1.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


capabilityList 


M 


swM. capabilityList 


Each entry in the list contains: 

• Id of SwMCapability 

• nEInf ormation of SwMCapability 

• swVersionToBelnstalledOf f erList of 
SwMCapability 

• stepsAndOf f eredStopPointList of SwMCapability 

• of feredFinalAdmini St rati vest ate Information 
of SwMCapability 


result 


M 


swM. result 


result = success and empty swMCapabilityList mean: No 
instance found. 



5.3.1.4 



Post-condition 



Assertion Name 


Definition 


dataDelivered 


The requested data is delivered. 
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5.3.1.5 
5.3.1.5.1 



5.3.2.1 



Exceptions 



operation_f ailed 



Exception Name 


Definition 


operation failed 


Condition: Pre-condition is false or post-condition is false. 
Returned Information: The output parameter result. 
Exit state: Entry state. 



5.3.2 Operation listSwMProf iles (M) 



Definition 



This operation allows the IRPManager to find out which instances of SwMProf lie are valid NEs of a certain 
type. 

Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 1 




3GPP TS 32.531 [6] 


REQ ASWM FUN 2 





5.3.2.2 



Input parameters 



Parameter 
Name 


Qualifier 


Information type 


***^^ Comment ^^^ 


nEInf ormation 


M 


swM . nEInf ormation 


If this input parameter contains no information, all profile instances are to 
be listed in the output. 



5.3.2.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


swMProf ileList 


M 


swM . swMProf ileList 


Each entry in the list contains: 

• Id of profile 

• versionNumber of swMprofile 

• nEInf ormation of profile 

• stepsAndSelectedStopPointList of profile 

• selectedFinalAdministrativeState of 
profile 

• conditionally swVersionToBelnstalled of 
swMprofile 


result 


M 


swM. result 





5.3.3 Operation createSwMProf ile (M) 



5.3.3.1 



Definition 



This operation allows the IRPManager to establish an instance of SwMProf ile to be valid for NEs of a 
certain type. 

Information on Requirements Traceability: 
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Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 2 





5.3.3.2 



Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


id 





swM. id 


Identifier of 
swMprofile 


nEInf ormation 


M 


swM . nEInf ormat ion 


See 4.5 


swVersionToBelnstalled 


M 


swM . SwVersionToBelnstalled 


See 4.5 


stepsAndSelectedStopPointList 


M 


swM . StepsAndSelectedStopPointList 


See 4.5 


selectedFinalAdministrativeState 


M 


swM . selectedFinalAdministrativeState 


See 4.5 



5.3.3.3 



Output parameters 



Parameter 
Name 


Qualifier 


Matching Information 


Comment 


id 


CM 


SwMProfile. id 


See tlie definition of the result field described below 


result 


M 


ENUM 

{ 

success, 

failure, 

nEInf ormat ionlnter sect ion, 

notAllowedBecauseOf OngoingSwmActivity 

} 


If result = success , then parameter id 
contains the id of the created swMProf ile . 
If result = failure , then parameter id is 
absent. 

If result = nEInf ormationlntersection, 
then parameter id contains the id of a 
swMProfile whose nEInf ormat ion would 
intersect with the proposed nEinf ormation for 
the new swMProfile, which was not created in 
this case. 
If result = 

notAllowedBecauseOfOngoingSwmOperation, 
then parameter id is absent. 



5.3.4 Operation deleteSwMProf ile (M) 
5.3.4.1 Definition 

This operation allows the IRPManager to delete an instance of swMProfile. 
Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 2 





5.3.4.2 



Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


id 


M 


swM. id 


Identifier of swMprofile 



5.3.4.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


result 


M 


swM. result 
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5.3.5 Operation listSwMProcesses (M) 
5.3.5.1 Definition 

This operation allows the IRPManager to find out the status of one or several swMProcess instances 
Infotmation on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 4 





5.3.5.2 



Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


nEIdentif ication 





swM . nEIdentif ication 


It describes for which NE the swMprocess is to be listed. 

If this parameter is not present, all swMprocess instances are to be 
listed in the output. 



5.3.5.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


swMprocessList 


M 


swM . swMprocessList 


See 4.5 


result 


M 


swM. result 


result = success and empty swMProcessList mean: No 
instance found 



5.3.6 Operation resumeSwMProcess (M) 



5.3.6.1 



Definition 



This operation allows the IRPManager to resume a SW management process which currently has stopped at 
a stop point step. 

Infotmation on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 3 





5.3.6.2 



Input parameters 



Parameter 
Name 


Qualifier 


Information type 


Comment 


id 


M 


swM. id 


Identifier of swMprocess 


startStepName 


M 


swM.NameOfStep 


The start step for the resume operation. 

If the current process step is equal to the startStepName value, the process 

will start from startStepName . 

If the current process step does not match the startStepName value, then it 

will be indicated in the result of the operation. Not matching 

StartStepName value can either be the case that the process has already 

started from the specified step (i.e. request is too late) or that the process has not 

yet reached the specified step (i.e request is too early). 
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5.3.6.3 



Output parameters 



Parameter Name Qualifier Matching Information Comment 


result 


M 


swM. result 





5.3.7 Operation swFallback (M) 
5.3.7.1 Definition 

This operation enables the IRPManager to initiate a SW fallback. 
Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ SWM FUN 6 





5.3.7.2 



Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


filter 


M 


swM. filter 


To describe properties of the NEs to be selected. 



5.3.7.3 



Output parameters 



Parameter 
Name 


Qualifier 


Matching 
Information 


Comment 


nEList 


M 


swM. nEList 


Each entry in the list contains: 

nEIdentif ication 

swFallbackStatus (values : f allbackSuccessful, 

f allbackUnsuccessful) 


result 


IVI 


swM. result 


• Success, 

• Partly successful - swFallbackStatus is 
f allbackUnsuccessful for at least one NE 

and f allbackSuccessful for at least one Other NE 

• Failure 

Empty NEList and Result=Success means: No NEs fulfilling filter 
were found. 
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5.3.8 Operation terminateSwMProcess (M) 
5.3.8.1 Definition 

This operation allows the IRPManager to terminate a SW management process which is currently ongoing 
Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 6 





5.3.8.2 Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


id 


M 


swM. id 


Identifier of swMprocess . 



5.3.8.3 Output parameters 



Parameter Name 


Qualifier 


Matching Information Comment 


result 


M 


swM. result 
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5.4 SwMIRPOperations_2 Interface (O) 

5.4.1 Operation changeSwMProf ile (O) 
5.4.1.1 Definition 

This operation allows the IRPManager to change an instance of SwMProfile. 

A change in a profile which was already used at the start of an swMProcess does not affect that swMProcess (which is 
run to its completion according to the former version of the profile. 

Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 2 





5.4.1.2 



Input parameters 



^ Parameter Name 


Qualifier 


Information type 


Comment 


id 


M 


swM. id 


Identifier of 
swMprofile 


nEInf ormation 


M 


swM . nEInf ormation 


See 4.5 


swVersionToBelnst ailed 


M 


swM. swVersionToBelnstalled 


See 4.5 


stepsAndSelectedStopPointList 


M 


swM . StepsAndSelectedStopPointList 


See 4.5 


selectedFinalAdministrativeState 


M 


swM. selectedFinalAdministrativeState 


See 4.5 



5.4.1.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


esult 


M 


ENUM 
{ 

success , 

failure, 

nEInformationlnter sect ion, 

notAllowedBecauseOfOngoingSwmActivity 

} 


If result = success or failure , then 

parameter id may be absent or contain the id of 

the changed swMprofile . 

If result = nEInf ormationlntersection, 

then parameter conf lictingProf ileld 

contains the id of a SwIVIProfile "A" whose 

nEInf ormation would intersect with the 

proposed nEinf ormation for the SwMProfile"B 

= input parameter id . SwIVIProfile'E" will not be 

changed in this case. 

If result = 

notAllowedBecauseOf OngoingSwmActivit^ 

(which means that the operation is rejected 

because another SWM activity is ongoing for at 

least one NE covered by input parameter 

ne Information), 

then parameter conf lictingProf ileld is 

absent. 


ersionNumber 


M 


SwMProfile . versionNumber 


See 4.5. This parameter has value when 
result <> success. 


onf lictingProf ileld 


C*) 


SwMProfile. id 


See definition of result above. 



Editor Note: whether this parameter needs to be conditional or mandatory needs further discussion. The condition: 

result is nEInformationlntersection 
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5.4.1.4 Constraints 



Name 



Definition 



result is nEInf ormationlntersection 



result is equal to nEInf ormationlntersection 
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5.5 SwMIRPNotifications_1 Interface (M) 

5.5.1 Notification notifySwMProf ileCreation (M) 
5.5.1.1 Definition 

This notification conveys information about the creation of an instance of IOC swMProfile. 



5.5.1.2 



Input parameters 



Parameter Name 


Qualifiers 


Matching Information 


Comment 


id 


M,Y 


swM. id 


Identifier of 
swMprofile 


versionNumber 


M, Y 


swM. versionNumber 


See 4.5 


nEInf ormation 


M,Y 


swM . nEInf ormat ion 


See 4.5 


swVersionToBelnstalled 


M,Y 


swM . SwVersionToBelnstalled 


See 4.5 


stepsAndSelectedStopPointList 


M,N 


swM . StepsAndSelectedStopPointList 


See 4.5 


selectedFinalAdministrativeState 


M,N 


swM. selectedFinalAdministrativeState 


See 4.5 



5.5.2 Notification notifySwMProf ileDeletion (M) 
5.5.2.1 Definition 

This notification conveys information about the deletion of an instance of IOC swMProfile. 
Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 2 





5.5.2.2 



Input parameters 



Parameter Name 


Qualifiers 


Matching Information 


Comment 


id 


M,Y 


swM. id 


Identifier of swMprofile 
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5.5.3 Notification notifySwMProcessCreation (M) 
5.5.3.1 Definition 

This notification conveys information about the creation of an instance of IOC swMProcess. 
Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 2 





5.5.3.2 



Input parameters 



Parameter Name 


Qualifiers 


Matching Information 


Comment 


id 


M,Y 


swM. id 


Identifier of swMprocess 


nEIdentif ication 


M,Y 


swM . nEIdentif ication 


see 4.5 


prof ileld 


M,N 


swM. prof ileld 


see 4.5 


matchingNEInf ormation 


M,N 


swM. matchingNEInf ormation 


see 4.5 


stepinf oList 


M,N 


swM. stepinf oList 


see 4.5 



5.5.4 Notification notifySwMProcessStage (M) 



5.5.4.1 



Definition 



This notification conveys information about the stage of an instance of IOC swMProcess that has been 
completed or at which that process has been stopped (based on pre-set stop points). 

Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 5 





5.5.4.2 



Input parameters 



Parameter Name 


Qualifiers 


Matching Information 


Comment 


id 


M,Y 


swM. id 


Identifier of swMprocess 


stepinf oList 


M,N 


swM . stepinf oList 


see 4 . 5 
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5.5.5 Notification notifySwMProcessDeletion (M) 
5.5.5.1 Definition 

This notification conveys information about the deletion of an instance of IOC swMProcess 

IRP Agent shall also send out this notification in case of a process termination caused by an exception, for example IRP 
Agent terminates the process because it had to wait too long after a suspend operation. 

Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 2 





5.5.5.2 



Input parameters 



Parameter Name 


Qualifiers 


Matching Information 


Comment 


id 


M,Y 


swM. id 


Identifier of swMprocess 


triggerForDeletion 


M, Y 


swM. triggerForDeletion 


This parameter describes what triggered the 
deletion of the swMprocess instance: 
triggerForDeletion : 

irpAgentTermination, 

irpManagerTermination, 

automatedSWMSuccesfullyConcluded 


additional Information 


0, N 


swM. additionalinf ormation 





5.5.6 Notification not ifyNewSwAvai lability (M) 
5.5.6.1 Definition 

This notification conveys information about the availability of new SW. 
Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ SWM FUN 3 





5.5.6.2 



Input parameters 



Parameter Name 


Qualifiers 


Matching Information 


Comment 


nEandSWversion 


M,Y 


swM. NEandSWversion 


Informs about new available SW, SW version and NE / NE 
version (types) for which it is valid 
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5.6 SwMIRPNotifications_2 Interface (O) 

5.6.1 Notification notifySwMProf ileChange (C/0) 
5.6.1.1 Definition 

This notification conveys information about a change of an instance of IOC swMProf ile. 
Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 2 





5.6.1.2 



Input parameters 



Parameter Name 


Qualifiers 


Matching Information 


Comment 


id 


M,Y 


swM. id 


Identifier of 
swMprofile 


versionNumber 


M,Y 


swM .vers ionNumber 


See 4.5 


nEInf ormation 


M,Y 


swM . nEInf ormat ion 


See 4.5 


swVersionToBelnstalled 


M,N 


swM. swVersionToBelnstalled 


See 4.5 


stepsAndSelectedStopPointList 


M,N 


swM. StepsAndSelectedStopPointList 


See 4.5 


selectedFinalAdministrativeState 


M 


swM . selectedFinalAdministrativeState 


See 4.5 



5.7 SwMIRPOperations_3 Interface (M) 



Editor's Note; Whether non-automatic software management interface is optional or mandatory need further study. 



5.7.1 Operation downloadNESw (M) 



5.7.1.1 



Definition 



This operation allows IRPManager to request an IRP Agent to download network element software entities from a 
specified location. IRPManager provides a unique reference where IRP Agent can download NE software from. 

Note: The file transfer may not happen over Itf-N and the details on how to transfer file from IRP Agent to NE(s) is 
vendor specific and outside the scope of this specification. 

Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ_NASWM_FUN_1 




3GPP TS 32.531 [6] 


REQ_NASWM_FUN_2 
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5.7.1.2 



Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


swToBeDownloaded 


M 


List of STRUCT < 

swLocation, 

swFileSize, 

swFileCompression, 

swFileFormat 
> 


These attributes represent information about 
the NE software which will be downloaded by 
IRPAgent. 

swLocation: Denotes a unique location of 
software. This attribute includes the name of 
the software or a software version. 

swFileSize: It identifies the size of the file. Its 
value is positive Integer (the unit is byte). It is 
optional to fill in this attribute value. 

swFileCompression: It identifies the name of 
the compression algorithm used for the file. 
An empty fileCompression means that there 
is no compression on the file. Choice of 
compression algorithm is vendor-specific but 
is encouraged to use industrial standard 
algorithm such as GZIP. It is optional to fill in 
this attribute value. 

swFileFormat: It identifies the encoding 
technique used by the file. It is optional to fill 
in this attribute value 


neldentif ier 


M 


Distinguished Name (DN) 


Identifies the destination where the software 
can be downloaded and can include network 
element, managed element or managed 
functionality etc. The information is 
represented using a full Distinguished Name 
according to 3GPP TS 32.300. 



5.7.1.3 



Output parameters 



Parameter Name 


Qualifier 


IVIatching Information 


Comment 


downloadProcessId 


M 


Integer 


An Identifier generated by IRPAgent upon receiving a 

non-automated software management request from 

IRPManager. 

In this case, it identifies the NE software download 

operation request. 


result 


M 


ENUM 

{ 

requestAccepted, 

requestFailed, 

notAllowedBecauseOf OngoingSwmActivity 

} 


Indicates whether SwMIRP has accepted or rejected 
the download request. 

It can have any one of the three possible values: 

- "requestAccepted" which means that IRPAgent 
would perform the NE software download operation 

- "requestFailed" which means that IRPAgent has 
failed to initiate the NE software download 
operation. Specific error condition can be captured 
in reason field 

- notAllowedBecauseOf OngoingSwmActivity 
which means that the operation is rejected because 
another SWIVI activity is ongoing for the requested 
NE.. 


reason 





String 


To capture detailed error reason. The field is empty 
when there is no error. 
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5.7.1.4 



Pre condition 



Assertion Name 


Definition 


swDownloadable 


NE software is available which IRPAgent can download 



5.7.1.5 



Post-condition 



Assertion Name 


Definition 


swDownloadlnProgress 


The SwMIRP has accepted the download request to perform the requested 
operation. 


swAvailable 


This is the final state when downloadNESw operation is complete and 
notifyDownloadNESwStatusChanged has been generated. 



5.7.1.6 



Exceptions 



Exception Name 


Definition 


operationFailed 


Condition: Pre-condition is false or post-condition is false. 
Returned Information: The output parameter status. 
Exit state: Entry state. 


resourceLimitation 


Condition: Operation not performed due to resource limitation. 
Returned Information: The output parameter status. 
Exit state: Entry state. 



5.7.2 Operation activateNESw (M) 



5.7.2.1 



Definition 



This operation allows IRPManager to activate network element software entity which has been previously downloaded 
or installed on the request of IRPManager. This operation may be service affecting. 

Note: activateNESw can be triggered through automatic or manual ways. 

Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ_NASWM_FUN_5 





5.7.2.2 



Input parameters 



1 Parameter Name 


Qualifier 


Information type 


Comment 


swVersionToBeActivated 


M 


swVersion 


swVersion denotes the software version which would be 
activated. The details on how to activate a software version is 
vendor specific. 


neldentif ier 


M 


Distinguished 
Name (DN) 


Identifies the destination where software has to be activated. 
This is a full Distinguished Name according to 
3GPP TS 32.300 
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5.7.2.3 



Output parameters 



Parameter Name 


Qualifier 


IVIatching Information 


Comment 


activateProcessId 


M 


Integer 


An Identifier is generated by IRPAgent upon receiving a 
non-automated software management request from 
IRPIVIanager. In this case, it identifies the NE software 
activation operation request. 


result 


M 


ENUM 

{ 

requestAccepted, 

requestFailed, 

notAllowedBecauseOf OngoingSwmActivity 

} 


Indicates whether SwMIRP has accepted or rejected 
the NE software activation request. 

It can have any one of the three possible values: 

- "requestAccepted" which means that IRPAgent 
would perform the NE software activation operation 

- "requestFailed" which means that IRPAgent has 
failed to initiate the NE software activation 
operation. Specific error condition can be captured 
in reason field 

- notAllowedBecauseOf OngoingSwmActivity 
which means that the operation is rejected because 
another SWIVI activity is ongoing for the requested 
NE.. 


reason 





String 


To capture specific error conditions. The field is empty 
when there is no error. 



5.7.2.4 Pre condition 



swAvailable or swinstalled 



Assertion Name 


Definition 


swAvailable 


The NE software has been successfully downloaded 


swinstalled 


The NE software has been installed 



5.7.2.5 Post-condition 



Assertion Name 


Definition 


swActivationlnProgress 


The SwIVIIRP has accepted the request to perform the requested activation operation. 


swActivated 


This is the final state when activateNESw operation is complete and 
notifyActivateNESwStatusChanged has been generated 



5.7.2.6 Exceptions 



Exception Name 


Definition 


operationFailed 


Condition: Pre-condition is false or post-condition is false. 
Returned Information: The output parameter status. 
Exit state: Entry state. 


resourceLimitation 


Condition: Operation not performed due to resource limitation. 
Returned Information: The output parameter status. 
Exit state: Entry state. 



5.8 SwMIRPOperations_4 Interface (O) 
5.8.1 Operation installNESw (O) 



5.8.1.1 



Definition 



This operation allows IRPManager to initiate installation of NE software entity which has been previously downloaded 
on the request of IRPManager. Installation may also be initiated from a remote location. 

Infonnation on Requirements Traceability: 
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Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ_NASWM_FUN_3 




3GPP TS 32.531 [6] 


REQ_NASWM_FUN_4 





5.8.1.2 



Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


swTobe Ins tailed 


M 


swLocation 


swLocation denotes a unique location (local 
or remote) of software which can be a 
directory path or a URL and includes 1) the 
name of software or 2) a software version 


neldentif ier 


M 


Distinguished Name (DN) 


Identifies the destination where the NE 
software needs to be installed. This is a full 
Distinguished Name according to 
3GPP TS 32.300 



5.8.1.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


ins tall Process Id 


M 


Integer 


An Identifier generated by IRPAgent upon receiving a 
non-automated software management request from 
IRPIVIanager. In this case, it identifies the NE software 
installation operation request. 


result 


M 


ENUM 

{ 

requestAccepted, 

requestPailed, 

notAllowedBecauseOfOngoingSwmActivity 

} 


Indicates whether SwIVIIRP has accepted or rejected 
the installation request. 

It can have any one of the twhreeo possible values: 

- "requestAccepted" which means that IRPAgent uld 
perform the NE software installation operation 

- "requestPailed" which means that IRPAgent has 
failed to initiate the NE software installation 
operation. Specific error condition can be captured 
in reason field 

- notAllowedBecauseOfOngoingSwmActivity 
which means that the operation is rejected because 
automatic SWM is ongoing for the requested NE.. 


reason 





String 


To capture detailed error conditions. The field is empty 
when there is no error. 



5.8.1.4 



Pre condition 



Assertion Name 



Definition 



swAvailable 



NE software is available 



5.8.1.5 



Post-condition 



Assertion Name 


Definition 


swInstallationlnProgress 


The SwIVIIRP has successfully accepted the request to perform the requested 
installation operation 


swinstalled 


This is the final state when installNESw operation is complete and 
notifyinstallNESwStatusChanged has been generated 
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5.8.1.6 



Exceptions 



Exception Name 


Definition 


operationFailed 


Condition: Pre-condition is false or post-condition is false. 
Returned Information: The output parameter status. 
Exit state: Entry state. 


resourceLimitation 


Condition: Operation not performed due to resource limitation. 
Returned Information: The output parameter status. 
Exit state: Entry state. 


swNotAvailable 


Condition: NE software is not available. 

Returned Information: The output parameter status. 

Exit state: Entry state. 
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5.9 SwMIRPNotifications_3 Interface (M) 

5.9.1 Notification notifyDownloadNESwStatusClnanged (M) 
5.9.1.1 Definition 

This notification, generated by IRP Agent conveys information about the status of the downloadNESw operation. 
Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ_NASWM_FUN_1 
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5.9.1.2 Input parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


objectClass 


M, Y 


SwMManagedEntity.objectClass 


Represents the network element 
object class generating this event. 
Also refer to Notification header [9]. 


objectlnstance 


M,Y 


SwMManagedEntity.objectlnstance 


Represents the network element 
instance generating the event. Also 
refer to Notification header [9]. 


notif icationid 


0,N 


— 


Refer to Notification header [9]. 


eventTime 


M,Y 


— 


Refer to Notification header [9]. 


systemDN 


C,Y 


— 


Refer to Notification header [9]. 


notif icationType 


M,Y 


"notifyDownloadNESwStatusChanged" 




downloadProcessId 


M, Y 


Integer 


To allow IRPManager correlate this 
notification with the downloadNESw 
operation request. Also refer to 
section 5.7.1 


downloadOperat ionStatus 


M,Y 


enum { 

NE SWDOWNLOAD SUCCESSFUL, 

NE SWDOWNLOAD FAILED, 

NE SWDOWNLOAD PARTIALLY SUCCESSFUI 

} 


Provides information on the status of 

downloadNESw operation for the 

network element involved. 

Note: When only one software entity 

has to be downloaded, 

downloadOperationStatus can be 

either 

NE SWDOWNLOAD SUCCESSFU 

or NE_SWDOWNLOAD_FAILED. 


downloadedNESwInf o 


0,N 


LIST<DownloadedNESw> 


Information on where the software 
or version got downloaded on the 
NE 


f ailedSwInf o 


0,N 


LIST<FailedSw, FailureReason> 


Information on software not abled to 
be downloaded and the 
corresponding failure reason. 



5.9.1.3 



Triggering Event 



5.9.1.3.1 From State 

neSwDownloadlnProgress 



Assertion Name 


Definition 


neSwDownloadlnProgress 


IRPAgent has accepted the request to download software and downloadProcessId is 
available 



5.9.1.3.2 



To State 



neSwDownloadSuccessful or neSwDownloadFailed or neSwDownloadPartiallySuccessful . 



Assertion Name 


Definition 


neSwDownloadSuccessful 


Software has been successfully downloaded. When multiple software have to be 
downloaded, it means that all software entities have been downloaded successfully 


neSwDownloadFailed 


Software has not been downloaded. When multiple software have to be 
downloaded, it means that no software has been downloaded 


neSwDownloadPartiallySuccessful 


At least one of the software has not been downloaded (hence can be used only 
when multiple software need to be downloaded) 



5.9.1.4 



None 



Constraints 
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5.9.2 Notification notifyActivateNESwStatusClnanged (M) 



5.9.2.1 



Definition 



This notification, generated by IRPAgent conveys infomiation about the status of the activateNESw 
operation. 

Infomiation on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ_NASWM_FUN_5 





5.9.2.2 



Input parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


objectClass 


M, Y 


SwMManagedEntity.objectClass 


Represents the network 
element object class 
generating this event. 
Also refer to Notification 
header [9]. 


object Instance 


M, Y 


SwMManagedEntity.objectlnstance 


Represents the network 
element instance 
generating the event. 
Also refer to Notification 
header [9]. 


notif icationid 


0,N 


— 


Refer to Notification 
header [9]. 


eventTime 


M,Y 


— 


Refer to Notification 
header [9]. 


systemDN 


C,Y 


— 


Refer to Notification 
header [9]. 


notif icationType 


M,Y 


"notifyActivateNESwStatusChanged" 




activateProcessId 


M, Y 


Integer 


To allow IRPManager 
correlate this notification 
with the activateNESw 
operation request. Also 
Refer to section 5.7.2 


activateOperationStatus 


M,Y 


ENUM{ 

NE SWACTIVATION SUCCESSFUL, 

NE SWACTIVATION FAILED, 

NE SWACTIVATION PARTIALLY SUCCESSFUL 
} 


Provides information on 
the status of 
activateNESw operation 
for the network element 
involved. When the 
activation could get 
completed to only a 
certain extent, partial 
success may be used. 


swVersionActivated 


0, Y 


swVersion 


The software version 
which has been 
activated. If the sotware 
activation is not 
successful, it would be 
NULL. 


f ailureReason 


0,N 


String 


The error reason when 
the activateNESw 
operation is not 
successful. 
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5.9.2.3 



Triggering Event 



5.9.2.3.1 From State 

neSwActivationlnProgress 



Assertion Name 



Definition 



neSwActivationlnProgress 



RPAgent lias accepted the request to activate software and activateProcessId is available 



5.9.2.3.2 



To State 



neSwActivationSuccessful or neSwActivationFailed or 
neSwActivationPartiallySuccessful . 



Assertion Name 


Definition 


neSwActivationSuccessful 


Software has been successfully activated. 


neSwActivationFailed 


Software has not been activated. 


neSwActivationPartiallySuccessful 


When activation can be completed only to a certain extent, partial success may be 
used. 



5.9.2.4 

None 



Constraints 



5.10 SwMIRPNotifications_4 Interface (O) 

5.1 0.1 Notification notifylnstallNESwStatusChanged (O) 
5.10.1.1 Definition 

This notification, generated by IRP Agent conveys information about the status of the installNESw operation. 
Infonnation on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ_NASWM_FUN_3 
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5.1 0.1 .2 Input parameters 



Parameter Name 


Qualifier 


IVIatching Information 


Comment 


objectClass 


M, Y 


SwMManagedEntity.objectClass 


Represents the network 
element object class 
generating this event. 
Also refer to Notification 
header [9]. 


objectlnstance 


M, Y 


SwMManagedEntity.objectlnstance 


Represents the network 
element instance 
generating the event. 
Also refer to Notification 
header [9] 


notif icationid 


0,N 


— 


Refer to Notification 
header [9]. 


eventTime 


M,Y 


— 


Refer to Notification 
header [9]. 


systemDN 


C,Y 


~ 


Refer to Notification 
header [9]. 


notif icationType 


M,Y 


"notifylnstallNESwStatusChanged" 




installProcessId 


M, Y 


Integer 


To allow IRPManager 
correlate this notification 
with the installNESw 
operation request. Also 
refer to section 5.8.1 


installOperationStatus 


M,Y 


ENUM{ 

NE SWINSTALLATION SUCCESSFUL, 
NE SWINSTALLATION FAILED, 
NE SWINSTALLATION PARTIALLY SUCCESSFUL 

} 


Provides information on 
the status of installNESw 
operation for the network 
element involved. 


installedNESwInfo 


0,N 


LIST<lnstalledNESw> 


Information on where the 
software or version got 
installed on the NE 


f ailedSwInf o 


0,N 


LIST<FalledSw, FallureReason> 


It provides information 
on the software which 
failed in installation 



5.10.1.3 Triggering Event 
5.10.1.3.1 From State 

neSwInstallationlnProgress 



Assertion Name 



Definition 



neSwInstallationlnProgress 



IRPAgent has accepted the request to install software and InstallProcessId is available 



5.10.1.3.2 



To State 



neSwInstallationSuccessful or neSwInstallationFailed or 
neSwInstallationPartiallySuccessful . 



Assertion Name 


Definition 


neSwInstallationSuccessful 


Software has been successfully installed 


neSwInstallationFailed 


Software has not been installed 


neSwInstallationPartiallySuccessful 


At least one of software has not been installed 



5.10.1.4 

None. 



Constraints 
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Annex A (informative): Change history 



Change history 
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TSG# 
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CR 
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Old 
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SP-42 


SP-080717 
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1.0.0 


8.0.0 


2009-06 


SP-44 


SP-090408 


001 


- 


Correction of naming errors 


8.0.0 


8.1.0 


2009-06 


SP-44 


SP-090408 


002 
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